home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / prgmen14.lzh / PRGMENU.TXT < prev   
Text File  |  1989-07-19  |  6KB  |  170 lines
  1.                               Dr. Bob's Menu Helper
  2.                         ****    PRG version  1.14   ****
  3.                                     07/09/89
  4.                                     
  5.                              Copyright 1989 W.D.Parks
  6.                              
  7. Updated: 07/10/89 **** 1.10
  8. Updated: 07/14/89 **** 1.12
  9.          07/16/89 **** 1.14
  10.                              
  11. Overview:
  12.  
  13.         A simple PRG dispatcher.
  14.         
  15.         
  16. Functions:
  17.  
  18.          Up to eight (8) GEM programs may be listed in a MENu file.
  19.          At this time, only GEM or TOS programs (not TTP) are expected;
  20.          no feature exists for a command line to be passed.
  21.          
  22. Programability:
  23.  
  24.          When PRGMENU is executed, it clears the screen and then attempts
  25.          to read a default menu file, PRGMENU.MEN. It then displays that
  26.          file's contents as the available selections.
  27.          
  28.          If PRGMENU.MEN cannot be found in the default path then the
  29.          file_selector is called to search for any .MEN files to be loaded.
  30.          Aborting the File Selector will return you to the Desktop.
  31.          
  32.          A MENu file is a simple ascii file where each line contains a
  33.          path specification for each menu selection...
  34.          
  35.          sample .MEN file:
  36.          
  37. (line#1) C:\MEGAROIDS.PRG<cr>
  38.          C:\PRINMENU1.PRG<cr>
  39.          D:\CAL\START.PRG<cr>
  40.          E:\WP\PAGESTREAM\PAGESTREAM.PRG<cr>
  41.          C:\ARCSHELL.PRG<cr>
  42.          G:\GENST2.PRG<cr>
  43.          D:\BAS\HBASIC.PRG<cr>
  44.          G:\ED.PRG<cr>
  45.          
  46.          
  47.  Each line is terminated with the standard CR/LF  (or a sole CR)...
  48.  A line must start with the drive letter and must not have
  49.  trailing spaces.
  50.  (version 1.1x allows trailing spaces and also comments delimited by ";")
  51.   
  52.  A selection is made by pressing a number key 1-8. ESCape will exit
  53.  to the desktop...
  54.  The 0 (zero) key, loads an alternate MEN file via the file selector.
  55.  The ESCAPE key will exit to the Desktop. 
  56.  
  57.  PRGMENU was designed on a mono system, but should also work on color.
  58.  Color has not been tested as of this writing, so give a hollar if'n
  59.  it don't wanna work....
  60.  
  61. * Color HAS been tested. MED rez is ok (even in version 1.10), but LOW
  62.   rez just didn't have the needed width, hence the narrowing of the
  63.   menu box... (now my mono screen is almost empty) So, LOW-rez works!
  64.    
  65.  
  66.  --------------------------------------------------------------------------
  67.  
  68. ****
  69.  
  70.  I found this lil program kinda neet... but It was irritating to have
  71.  each line NOT have trailing spaces (sometimes my editor gets funky).
  72.  And... Boy! It sure would be nice to just run a program that wasn't
  73.  listed in the menu...
  74.  
  75.  My main concern in designing this program was to keep overhead down
  76.  to a minimum; it isn't. And with the added lil ditties, the overhead
  77.  grows even more... but now I feel it's more comfortable to use...
  78.  
  79.  The program lists at about 4.5k, but expands to 8k when loaded. Most
  80.  of this extra space is simply GEM variables. My intentions are to add
  81.  the standard menu-bar but then the size will grow even more...
  82.  
  83.  
  84.  * also fixed a lil irritation: A menu file with more than 8 lines
  85.    would print line#9, un-aligned... It don't do it no more now!
  86.  
  87.  
  88.  
  89. **** 07/14/89 ****
  90.  
  91.   Modifications:
  92.   
  93. *  Only the program name is displayed in the menu box.
  94.    (this may or may not be an improvement. Hard drive users sing, "Oh well")
  95.  
  96. *  A User-Title is checked for in the MEN file and if found will be
  97.    displayed in the menu box (guess where!).
  98.    A menu box title is specified in the first line of the file by
  99.    an asterisk. (If no asterisk, then a program path is assumed.)
  100.    
  101. Sample file:   
  102.     
  103. (line#1) *18 character title <cr>
  104.          C:\MEGAROIDS.PRG     ;asteroids game<cr>
  105.          C:\PRINMENU1.PRG     ;DB's printer menu <cr>
  106.          D:\CAL\START.PRG     ;DB's calendar<cr>
  107.          E:\WP\PAGESTREAM\PAGESTREAM.PRG  <cr>
  108.          C:\ARCSHELL.PRG <cr>
  109.          G:\GENST2.PRG     ;assembler<cr>
  110.          D:\BAS\HBASIC.PRG <cr>
  111.          G:\ED.PRG  ;non existant but so what<cr>
  112.          I:\garbage\trash\junque.prg   ;this item (#9) will not show 
  113.  
  114.  
  115.  
  116.  
  117. **** 07/16/89
  118.  
  119.      Some programs (particularly those that "fiddle" with undocumented
  120.      aspects of the ST, and those that cannot exit in an orderly manner)
  121.      cause aggrevating crashes if the ST is not reset.
  122.  
  123.      PRGMENU.prg uses the simplest method available in gemdos to run
  124.      a program. There are no extra cookies tossed about, no mysterious
  125.      addresses modified, no secret doors that get locked or unlocked.
  126.      It was my intent to keep as pure a setup as possible to allow ANY
  127.      legitimately written program to be executed. 
  128.  
  129.      But  "Wouldn't ya know it!"
  130.      
  131.      So. The solution:
  132.      
  133.      PRGMENU will now allow you to specify which menu items should reset
  134.      your ST after running. I use this feature with Pagestream due to it's
  135.      NEVER resetting the memory allocation properly and never allowing
  136.      the desktop to gain COMPLETE control.
  137.      
  138.      
  139.      "Well, how do you do this?"
  140.       
  141.       Funny you should ask...
  142.       
  143.       In the .MENu file, simply start the line with an exclamation point.
  144.       
  145. run normally:      C:\JOEY.PRG
  146. reset on exit:     !C:\JOEY.PRG
  147.  
  148.       Each item will display as usual in the menu box, with the addition
  149.       of a "!" beside the item that will cause a RESET when done.
  150.       
  151.       This works great on many games and many disk copying utilities.
  152.       
  153.  
  154.       
  155.      
  156.  
  157.  
  158.  
  159.  
  160.  Leave E-Mail to: Dr. Bob
  161.  on CHQ BBS  216 758-0284   24hrs 1200/2400 bps
  162.  or US Mail to POB 45, Girard, OH 44420
  163.  
  164.  
  165.  
  166.   
  167.                                                       W.D.Parks
  168.                                                       7/10/89
  169.                                                                
  170.